<?php

//API信息概览
/**
 * @OA\OpenApi(
 *    @OA\Server(
 *      url="http://api.myapp.com/",
 *      description="API服务接口"
 *    ),
 *    @OA\Info(
 *      version="1.0",
 *      title="EasyApi—前后端分离快速应用开发框架",
 *      description="<span style='color:red;'>注意：</span>当前是后台Api模块接口。"
 *    )
 * )
 */

//通用头部参数
/**
 * @OA\Parameter(
 *    parameter="AppClientVersion",
 *    name="App-Client-Version",
 *    in="header",
 *    required=false,
 *    @OA\Schema( type="string" ),
 *    example="1.0"
 *  )
 */
/**
 * @OA\Parameter(
 *    parameter="AppDeviceType",
 *    name="App-Device-Type",
 *    in="header",
 *    required=false,
 *    @OA\Schema( type="string" ),
 *    example="web"
 *  )
 */

//通用响应返回
/**
 * @OA\Schema(
 *     schema="response",
 *     required={"code", "msg"},
 *     @OA\Property(
 *         property="code",
 *         type="integer",
 *         format="int10",
 *         description="返回码，小于等于0失败，1成功",
 *         example="1"
 *     ),
 *     @OA\Property(
 *         property="msg",
 *         type="string",
 *         description="返回消息",
 *         example="成功"
 *     ),
 *     @OA\Property(
 *         description="返回数据",
 *         property="data",
 *         type="object",
 *         example={}
 *     )
 * )
 */

//通用列表参数
/**
 * @OA\Parameter(
 *   parameter="keywords",
 *   name="keywords",
 *   description="关键字搜索",
 *   @OA\Schema( type="string" ),
 *   in="query"
 * )
 */
/**
 * @OA\Parameter(
 *   parameter="order",
 *   name="order",
 *   description="排序方式，仅支持create_time、size",
 *   @OA\Schema( type="string" ),
 *   example="create_time DESC",
 *   in="query"
 * )
 */
/**
 * @OA\Parameter(
 *   parameter="size",
 *   name="size",
 *   description="每页显示数量",
 *   @OA\Schema( type="integer" ),
 *   example="20",
 *   in="query"
 * )
 */
/**
 * @OA\Parameter(
 *   parameter="page",
 *   name="page",
 *   description="当前分页",
 *   @OA\Schema( type="integer" ),
 *   example="1",
 *   in="query"
 * )
 */
